←Select platform

ConvertDirectToImage(ConversionColorFormat,ConversionColorFormat,byte[],int,RasterImage,int,int,int,int) Method

Summary

Converts image data in a managed buffer from one color conversion model directly to RGB\BGR using built-in algorithms, and sets the output as a RasterImage.

Syntax
C#
VB
C++
public static void ConvertDirectToImage( 
   ConversionColorFormat srcFormat, 
   ConversionColorFormat destFormat, 
   byte[] srcBuffer, 
   int srcBufferOffset, 
   RasterImage image, 
   int width, 
   int height, 
   int inAlign, 
   int outAlign 
) 
Public Shared Sub ConvertDirectToImage( 
   ByVal srcFormat As ConversionColorFormat, 
   ByVal destFormat As ConversionColorFormat, 
   ByVal srcBuffer() As Byte, 
   ByVal srcBufferOffset As Integer, 
   ByVal image As RasterImage, 
   ByVal width As Integer, 
   ByVal height As Integer, 
   ByVal inAlign As Integer, 
   ByVal outAlign As Integer 
) 
public:  
   static void ConvertDirectToImage( 
       ConversionColorFormat^ srcFormat, 
      ConversionColorFormat^ destFormat, 
      array<Byte>^ srcBuffer, 
      int srcBufferOffset, 
      RasterImage^ image, 
      int width, 
      int height, 
      int inAlign, 
      int outAlign 
   ) 

Parameters

srcFormat

Format of the input data.

destFormat

Format of the output data.

srcBuffer

A pointer to the buffer containing the input data.

srcBufferOffset

Offset to the first byte of the srcBuffer data buffer.

image

A RasterImage object that will hold the converted data.

width

Width of pixels to be processed.

height

Height of pixels to be processed.

inAlign

Each scanline in the input buffer is a multiple of inAlign bytes.

outAlign

Each scanline in the output buffer is a multiple of outAlign bytes.

Remarks

There is no need to call the Start and Stop methods to initialize or stop the conversion engine.

Converting from any color space to YCCK color space is currently not supported.

For more information about Alignment Parameters, refer to Alignment Parameters.

To convert to the Yp41 type, the input buffer length must be a multiple of 8.

Example

This example will convert BGR image to Lab color space, and then convert the Lab buffer to RasterImage, using the static method ConvertDirectToImage.

C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ColorConversion; 
 
public void ConvertDirectToImageExample() 
{ 
   // Initialize the RasterCodecs class 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup(); 
 
   // The input file name 
   string inputFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
 
   // load the input image as Bgr. 
   RasterImage bgrImage = codecs.Load(inputFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1); 
 
   // Image buffer array 
   byte[] bgrBuffer = new byte[bgrImage.BytesPerLine * bgrImage.Height]; 
 
   bgrImage.Access(); 
   // get image buffer 
   for (int i = 0; i < bgrImage.Height; i++) 
      bgrImage.GetRow(i, bgrBuffer, i * bgrImage.BytesPerLine, bgrImage.BytesPerLine); 
   bgrImage.Release(); 
 
   // Initialize a new Converter object 
   RasterColorConverterEngine converter = new RasterColorConverterEngine(); 
 
   // output Buffer array 
   byte[] labBuffer = new byte[bgrBuffer.Length]; 
 
   ConversionParameters convParams = new ConversionParameters(); 
 
   // Initialize the labParams structure property. 
   ConversionLabParameters labParameters = ConversionLabParameters.Empty; 
 
   // Set its properties 
   labParameters.AOffset = 128; 
   labParameters.ARange = 170; 
   labParameters.BOffset = 96; 
   labParameters.BRange = 200; 
   labParameters.LOffset = 0; 
   labParameters.LRange = 100; 
   labParameters.Mask = ConversionLabMaskFlags.AOffset | 
      ConversionLabMaskFlags.ARange | 
      ConversionLabMaskFlags.BOffset | 
      ConversionLabMaskFlags.BRange | 
      ConversionLabMaskFlags.LOffset | 
      ConversionLabMaskFlags.LRange; 
 
   convParams.LabParameters = labParameters; 
 
   // Initialize an image to hold the converted buffer. 
   RasterImage labImage = null; 
 
   try 
   { 
      // Start the color conversion 
      converter.Start(ConversionColorFormat.Bgr, ConversionColorFormat.Lab, null); 
 
      // Change the Lab properties 
      convParams.Method = ConversionMethodFlags.ChangeLab; 
 
      // Set the updated properties 
      converter.SetParameters(convParams); 
 
      // convert the image buffer  
      converter.Convert(bgrBuffer, // input buffer 
         0, // offset from the beginning of the source buffer 
         labBuffer, // output buffer 
         0, // offset from the beginning of the destination buffer 
         bgrImage.Width, // pixels width 
         bgrImage.Height, // pixels height 
         bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8)), 
         0); // 0 bytes align 
 
      // stop the conversion 
      converter.Stop(); 
 
      // Initialize labImage. 
      labImage = new RasterImage(RasterMemoryFlags.Conventional, bgrImage.Width, bgrImage.Height, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, null, IntPtr.Zero, 0); 
 
      // convert the image buffer 
      // The srcBufferOffset parameter is an offset to the start byte of the data in the source buffer. 
      // For example, if the image data started at byte 5, then this variable should = 5. 
      // In our example here, the image data starts at byte 0. 
 
      // Note that the srcBuffer can be also passed to this function as an IntPtr pointer. 
      RasterColorConverterEngine.ConvertDirectToImage( 
         ConversionColorFormat.Lab, 
         ConversionColorFormat.Bgr, 
         labBuffer, // converted buffer 
         0, // offset from the beginning of the source buffer 
         labImage, // image to be view 
         bgrImage.Width, // pixels width 
         bgrImage.Height, // pixels height 
         0, // 0 bytes align 
         bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8))); 
 
      // dispose the used image 
      bgrImage.Dispose(); 
   } 
   catch (Exception ex) 
   { 
      MessageBox.Show(ex.Message); 
   } 
 
   // Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown(); 
 
   // the output File Name. 
   string outputFileName = Path.Combine(LEAD_VARS.ImagesDir, "ResultImage.bmp"); 
 
   // Save the converted Image 
   codecs.Save(labImage, outputFileName, RasterImageFormat.Bmp, 24); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ColorConversion 
 
Public Sub ConvertDirectToImageExample() 
   ' Initialize the RasterCodecs class 
   Dim codecs As RasterCodecs = New RasterCodecs 
 
   ' StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup() 
 
   ' The input file name 
   Dim inputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp") 
 
   ' load the input image as Bgr. 
   Dim bgrImage As RasterImage = codecs.Load(inputFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1) 
 
   ' Image buffer array 
   Dim bgrBuffer(bgrImage.BytesPerLine * bgrImage.Height) As Byte 
 
   ' get image buffer 
   bgrImage.Access() 
   For i As Integer = 0 To bgrImage.Height - 1 
      bgrImage.GetRow(i, bgrBuffer, (i * bgrImage.BytesPerLine), bgrImage.BytesPerLine) 
   Next 
   bgrImage.Release() 
 
   ' Initialize a new Converter object 
   Dim converter As New RasterColorConverterEngine 
 
   ' output Buffer array 
   Dim labBuffer(bgrBuffer.Length) As Byte 
 
   ' Initialize a new ConversionParameters new class object. 
   Dim convParams As ConversionParameters = New ConversionParameters 
 
   ' Initialize the labParams class property. 
   Dim labParameters As ConversionLabParameters = ConversionLabParameters.Empty 
 
   ' Set its properties 
   labParameters.AOffset = 128 
   labParameters.ARange = 170 
   labParameters.BOffset = 96 
   labParameters.BRange = 200 
   labParameters.LOffset = 0 
   labParameters.LRange = 100 
   labParameters.Mask = ConversionLabMaskFlags.AOffset Or 
      ConversionLabMaskFlags.ARange Or 
      ConversionLabMaskFlags.BOffset Or 
      ConversionLabMaskFlags.BRange Or 
      ConversionLabMaskFlags.LOffset Or 
      ConversionLabMaskFlags.LRange 
 
   convParams.LabParameters = labParameters 
 
   ' Initialize an image to hold the converted buffer. 
   Dim labImage As RasterImage = Nothing 
 
   Try 
      ' Start the color conversion 
      converter.Start(ConversionColorFormat.Bgr, ConversionColorFormat.Lab, Nothing) 
 
      ' Change the Lab properties 
      convParams.Method = ConversionMethodFlags.ChangeLab 
 
      ' Set the updated properties 
      converter.SetParameters(convParams) 
 
      ' convert the image buffer  
      converter.Convert(bgrBuffer, 
         0, 
         labBuffer, 
         0, 
         bgrImage.Width, 
         bgrImage.Height, 
         CInt(bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8))), 
         0) 
 
      ' stop the conversion 
      converter.Stop() 
 
      ' Initialize labImage. 
      labImage = New RasterImage(RasterMemoryFlags.Conventional, bgrImage.Width, bgrImage.Height, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, Nothing, IntPtr.Zero, 0) 
 
      ' convert the image buffer 
      ' The srcBufferOffset parameter is an offset to the start byte of the data in the source buffer. 
      ' For example, if the image data started at byte 5, then this variable should = 5. 
      ' In our example here, the image data starts at byte 0. 
 
      ' Note that the srcBuffer can be also passed to this function as an IntPtr pointer. 
      RasterColorConverterEngine.ConvertDirectToImage( 
         ConversionColorFormat.Lab, 
         ConversionColorFormat.Bgr, 
         labBuffer, 
         0, 
         labImage, 
         bgrImage.Width, 
         bgrImage.Height, 
         0, 
         CInt(bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8)))) 
 
      ' dispose the used image 
      bgrImage.Dispose() 
   Catch ex As Exception 
      MessageBox.Show(ex.Message) 
   End Try 
   ' Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown() 
 
   ' the output File Name. 
   Dim outputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "ResultImage.bmp") 
 
   ' Save the result image. 
   codecs.Save(labImage, outputFileName, RasterImageFormat.Bmp, 24) 
 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class 
c#[Silverlight C# Example] 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ColorConversion; 
 
public void ConvertDirectToImageExample() 
{ 
   // Initialize the RasterCodecs class 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup(); 
 
   // The input file name 
   string inputFileName = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp"; 
 
   // load the input image as Bgr. 
   RasterImage bgrImage = codecs.Load(inputFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1); 
 
   // Image buffer array 
   byte[] bgrBuffer = new byte[bgrImage.BytesPerLine * bgrImage.Height]; 
 
   // get image buffer 
   for (int i = 0; i < bgrImage.Height; i++) 
      bgrImage.GetRow(i, bgrBuffer, i * bgrImage.BytesPerLine, bgrImage.BytesPerLine); 
 
   // output Buffer array 
   byte[] labBuffer = new byte[bgrBuffer.Length]; 
 
   // Initialize an image to hold the converted buffer. 
   RasterImage labImage = null; 
 
   try 
   { 
 
      // convert the image buffer  
      RasterColorConverterEngine.ConvertDirect(ConversionColorFormat.Bgr, 
         ConversionColorFormat.Lab, 
         bgrBuffer, // input buffer 
         0, // offset from the beginning of the source buffer 
         labBuffer, // output buffer 
         0, // offset from the beginning of the destination buffer 
         bgrImage.Width, // pixels width 
         bgrImage.Height, // pixels height 
         bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8)), 
         0); // 0 bytes align 
 
      // Initialize labImage. 
      labImage = new RasterImage(RasterMemoryFlags.Conventional, bgrImage.Width, bgrImage.Height, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, null, null, 0); 
 
      // convert the image buffer 
      // The srcBufferOffset parameter is an offset to the start byte of the data in the source buffer. 
      // For example, if the image data started at byte 5, then this variable should = 5. 
      // In our example here, the image data starts at byte 0. 
 
      // Note that the srcBuffer can be also passed to this function as an IntPtr pointer. 
      RasterColorConverterEngine.ConvertDirectToImage( 
         ConversionColorFormat.Lab, 
         ConversionColorFormat.Bgr, 
         labBuffer, // converted buffer 
         0, // offset from the beginning of the source buffer 
         labImage, // image to be view 
         bgrImage.Width, // pixels width 
         bgrImage.Height, // pixels height 
         0, // 0 bytes align 
         bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8))); 
 
      // dispose the used image 
      bgrImage.Dispose(); 
   } 
   catch (Exception) 
   { 
   } 
 
   // Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown(); 
 
   // the output File Name. 
   string outputFileName = LeadtoolsExamples.Common.ImagesPath.Path + "ResultImage.bmp"; 
 
   // Save the converted Image 
   codecs.Save(labImage, outputFileName, RasterImageFormat.Bmp, 24); 
} 
vb[Silverlight VB Example] 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ColorConversion 
 
Public Sub ConvertDirectToImageExample() 
   ' Initialize the RasterCodecs class 
   Dim codecs As RasterCodecs = New RasterCodecs() 
 
   ' StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup() 
 
   ' The input file name 
   Dim inputFileName As String = LeadtoolsExamples.Common.ImagesPath.Path & "Image1.cmp" 
 
   ' load the input image as Bgr. 
   Dim bgrImage As RasterImage = codecs.Load(inputFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1) 
 
   ' Image buffer array 
   Dim bgrBuffer As Byte() = New Byte(bgrImage.BytesPerLine * bgrImage.Height - 1) {} 
 
   ' get image buffer 
   Dim i As Integer = 0 
   Do While i < bgrImage.Height 
      bgrImage.GetRow(i, bgrBuffer, i * bgrImage.BytesPerLine, bgrImage.BytesPerLine) 
      i += 1 
   Loop 
 
   ' output Buffer array 
   Dim labBuffer As Byte() = New Byte(bgrBuffer.Length - 1) {} 
 
   ' Initialize an image to hold the converted buffer. 
   Dim labImage As RasterImage = Nothing 
 
   Try 
 
      ' convert the image buffer  
      RasterColorConverterEngine.ConvertDirect(ConversionColorFormat.Bgr, ConversionColorFormat.Lab, bgrBuffer, 0, labBuffer, 0, bgrImage.Width, bgrImage.Height, bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 
            8)), 0) ' 0 bytes align 
 
      ' Initialize labImage. 
      labImage = New RasterImage(RasterMemoryFlags.Conventional, bgrImage.Width, bgrImage.Height, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, Nothing, Nothing, 0) 
 
      ' convert the image buffer 
      ' The srcBufferOffset parameter is an offset to the start byte of the data in the source buffer. 
      ' For example, if the image data started at byte 5, then this variable should = 5. 
      ' In our example here, the image data starts at byte 0. 
 
      ' Note that the srcBuffer can be also passed to this function as an IntPtr pointer. 
      RasterColorConverterEngine.ConvertDirectToImage(ConversionColorFormat.Lab, ConversionColorFormat.Bgr, labBuffer, 0, labImage, bgrImage.Width, bgrImage.Height, 0, bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8))) 
 
      ' dispose the used image 
      bgrImage.Dispose() 
   Catch e1 As Exception 
   End Try 
 
   ' Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown() 
 
   ' the output File Name. 
   Dim outputFileName As String = LeadtoolsExamples.Common.ImagesPath.Path & "ResultImage.bmp" 
 
   ' Save the converted Image 
   codecs.Save(labImage, outputFileName, RasterImageFormat.Bmp, 24) 
End Sub 

Requirements

Target Platforms

Help Version 20.0.2020.3.31
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ColorConversion Assembly